home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d17 / imp400b.arc / CONTROL.DOC < prev    next >
Text File  |  1990-10-31  |  6KB  |  199 lines

  1.                                 CONTROL
  2.      --------------------------------------------------------------
  3.  
  4.  
  5.       WHAT IS CONTROL?
  6.  
  7.     CONTROL is a memory-resident program that allows you to easily
  8.     access the features of your printer. Simple commands, embedded
  9.     in your printed text, are converted into printer control
  10.     codes. You can also define text substitutions that allow you
  11.     to "boiler-plate" letters, forms, etc.
  12.  
  13.     Configuration files allow you to specify what effect each
  14.     embedded command has.
  15.  
  16.     CONTROL can be removed from memory without rebooting your
  17.     computer.
  18.  
  19.  
  20.       FILES INCLUDED WITH CONTROL
  21.  
  22.     The files are:
  23.  
  24.       CONTROL.EXE    The main memory-resident program.
  25.  
  26.       REM-CTRL.EXE    Removes CONTROL from memory.
  27.  
  28.       CONTROL.DAT    Sample data file for Epson or IBM printers.
  29.             It contains substitution definitions that
  30.             select bold, double width, etc.
  31.  
  32.       SAMPLE.DAT    Sample data file for text. It contains
  33.             example text substitutions.
  34.  
  35.     Both of the .DAT files are plain "ASCII" files. They contain
  36.     comments to help you understand their contents. 
  37.  
  38.  
  39.       LOADING CONTROL
  40.  
  41.     The syntax for loading CONTROL is:
  42.  
  43.       CONTROL  [-Tx]  [configuration_file]    [printer]
  44.  
  45.     All bracketed items following CONTROL are optional.
  46.  
  47.     The "-Tx" option allows you to select an alternate trigger
  48.     character for the embedded commands contained in the text that
  49.     you are sending to your printer. The character following the
  50.     "T" (here shown as an "x") becomes the new trigger character.
  51.     The default trigger character is a backslash ("\"). A typical
  52.     example of an embedded command would be:
  53.  
  54.       \BThis would print as bold, \Cand this wouldn't.
  55.  
  56.  
  57.  
  58.                                   1
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                 CONTROL
  68.      --------------------------------------------------------------
  69.  
  70.  
  71.     In the above example, "\B" turns on the bold feature of your
  72.     printer, and "\C" turns it off. (The "\B" and "\C" commands
  73.     could mean something entirely different; they are used here
  74.     only for the purpose of showing commands embedded within
  75.     text.)
  76.  
  77.     The trigger character is always immediately followed by a
  78.     character that identifies which substitution string is to
  79.     replace the embedded command. Upper and lower case are
  80.     equivalent for the second character. For example, "\b" and
  81.     "\B" are the same.
  82.  
  83.     The "configuration_file" option allows you to select an 
  84.     alternate configuration file. The default configuration file
  85.     is CONTROL.DAT. To load SAMPLE.DAT instead, type:
  86.  
  87.       CONTROL SAMPLE.DAT
  88.     
  89.     The "printer" option allows you to use CONTROL with a printer
  90.     connected to a printer port other than the default LPT1:
  91.     (PRN:). "Printer" can be LPT1:, LPT2: or LPT3:. For example,
  92.     to control the printer connected to LPT2:, type:
  93.     
  94.       CONTROL LPT2:
  95.  
  96.     To remove CONTROL from memory, run REM-CTRL from the DOS
  97.     prompt.
  98.  
  99.  
  100.       CONFIGURING CONTROL
  101.  
  102.     The CONTROL configuration file determines what strings are
  103.     substituted for the embedded commands contained in your text.
  104.     
  105.     The default CONTROL.DAT file contains the following
  106.     substitution definitions for an Epson or IBM printer:
  107.     
  108.       \B    :    turns on (B)old printing
  109.       \C    :    (C)ancels bold, underline, double width
  110.       \E    :    turns on (E)ight lines per inch printing
  111.       \N    :    turns off superscript and subscript
  112.       \S    :    turns on (S)ix lines per inch printing
  113.       \U    :    turns on (U)nderlining
  114.       \V    :    turns on subscript ("arrow" points down)
  115.       \W    :    turns on double (W)idth
  116.       \^    :    turns on superscript ("arrow" points up)
  117.       \<    :    turns on compressed mode
  118.       \>    :    turns on 10 characters per inch mode
  119.  
  120.     Configuration files must be in "ASCII" format. The file must
  121.     contain only printable characters ("A...Z, 0...9"), with no
  122.  
  123.  
  124.                                   2
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                 CONTROL
  134.      --------------------------------------------------------------
  135.  
  136.  
  137.     word processor or printer control codes. Most word processors
  138.     have a facility for editing and saving ASCII files.
  139.  
  140.     You may find the following explanation of the contents of a
  141.     configuration file easier to understand if you first copy
  142.     CONTROL.DAT to your printer with the following command:
  143.  
  144.       COPY CONTROL.DAT PRN:
  145.  
  146.     The substitution definitions contained in the configuration
  147.     file consist of a header character, followed by a colon,
  148.     followed by the substitution string. For example, to define
  149.     the string that will be substituted for "\B":
  150.  
  151.       B: {ESC} "E"
  152.  
  153.     In the above example, each occurence of "\B" in your text will
  154.     be replaced by the ESCAPE character, immediately followed by
  155.     an upper case E. This is the IBM or Epson command for bold
  156.     printing.
  157.  
  158.     Comments in a definition file are enclosed by parentheses "("
  159.     and ")".
  160.  
  161.     Special control character representations recognized are:
  162.  
  163.       {ESC}   This is the escape character (decimal 27, hex 1B)
  164.       {LF}      This is a line feed character
  165.       {CR}      This is a carriage return
  166.       {NL}      This is a newline (line feed, plus carriage return)
  167.       {TAB}   This is a tab character
  168.       {FF}      This is a form feed character
  169.  
  170.     Not all string substitutions have to be printer control commands.
  171.     You can define ordinary text substitutions. For example:
  172.  
  173.       A: "This is what will print if '\A' is sent to the printer"
  174.  
  175.     The parsing of the configuration file uses the following
  176.     rules:
  177.  
  178.       comment ::= (anything enclosed in parentheses)
  179.       substitution definition ::= header & body
  180.       header ::= alpha & :
  181.       alpha ::= ASCII characters greater than 32 (hex 20)
  182.       body ::= (string | number | control character) & separator
  183.       string ::= "anything enclosed in double quotes"
  184.       number ::= integer <= 255
  185.       control character ::= {ESC} | {LF} | {CR} | {NL} | {TAB} | {FF}
  186.       separator ::= SPACE | COMMA | TAB | LF | CR | FORMFEED
  187.  
  188.  
  189.  
  190.                                   3
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.